home *** CD-ROM | disk | FTP | other *** search
- .font Helvetica
- .fontsize 10
- .forecolor black
- .backcolor #ffffff
- .linkcolor #006800
-
- .include "style.help"
- .include "images.help"
- .include "changes.help"
- .include "howto.help"
-
- .image logo file logo.gif
-
- .topic contents
- .title Contents
- <p><img src=logo></p>
- <p>
- <img src=book> <a href=intro>Introduction</a><br>
- <img src=book> <a href=GPL>License</a><br>
- <img src=book> <a href=install>Install</a><br>
- <img src=openbook> HowTos
- <ul type=topic>
- <li> <a href=howtoDown>How to download a site</a>
- <li> <a href=howtoSingle>How to download a single file</a>
- <li> <a href=howtoPage>How to download a single page with images</a>
- <li> <a href=howtoTwoSites>How to download two files simultaneously</a>
- <li> <a href=howtoAuto>How to download all the sites in the queue</a>
- <li> <a href=howtoDelay>How to program a delayed download</a>
- <li> <a href=howtoProxy>How to configure a proxy</a>
- <li> <a href=howtoUpdate>How to update a former download</a>
- <li> <a href=howtoOther>How to save space</a>
- <li> <a href=translate>How to translate Getleft</a><br><br>
- <li> <a href=howtoHelp>How to get help</a>
- </ul>
- <br>
- <img src=book> <a href=register>Register Getleft</a><br>
- <br>
- <img src=book> <a href=changes>Change log</a><br>
- <img src=book> <a href=toDo>To do</a><br>
- <img src=book> <a href=credits>Credits</a><br>
- </p>
-
- .topic intro
- .title Introduction
- <p>
- <img src=logo></p>
- <p>
- Once upon a time I tried to download one month worth of a mailing
- list archive. I tried to do it with GetRight, but that program
- can only process up to 500 links in a web page, this archive had
- well over one thousand. At the same time, I learned that Tcl could
- download files, so I thought "How hard can it be to make my own
- program?"
-
- <p>So here is my little effort.
- It is supposed to download complete Web sites. You give it an URL,
- and down it goes on, happily downloading every linked URL in
- that site.
-
- <p>While it goes, it changes the original pages, all the links
- get changed to relative links. so that you can surf the site in
- your hard disk without those pesky absolute links.
-
- <h2>What this program is not</h2>
-
- <P>A <a href="tcl:Ayuda::InvokeBrowser http://www.getright.com">GetRight</a>
- substitute, I have seen in Usenet that some people
- seem to think so, while I get a big ego boost from reading it,
- the fact remains it isn't.
-
- <h2>What this program has not</h2>
-
- <p>A capital 'L', believe me, one capital per word is good enough for me.
-
- <h2>What this program lacks</h2>
-
- <P>Getleft doesn't support Java, Javascript, ... It only understands plain Html.
-
- <h2>Getleft at SourceForge</h2>
- <p>You can also check
- <a href="tcl:Ayuda::InvokeBrowser http://sourceforge.net/projects/getleftdown/">Getleft's page at SourceForge</a>,
- at the moment there is nothing much to see there, but you can already file bug reports,
- request support, suggest new features, ...<br><br>
-
- <p>You can also subscribe to the
- <a href="tcl:Ayuda::InvokeBrowser http://lists.sourceforge.net/lists/listinfo/getleftdown-user">mailing list</a>
- they provide for Getleft.
-
- <h2>Features</h2>
- <ul>
-
- <li>While it goes, it changes the original pages, all the links
- get changed to relative links, so that you can surf the site in
- your hard disk without those pesky absolute links.<br><br>
- <li>Limited Ftp support, it will download the files but not recursively.<br><br>
- <li>Resumes downloading if interrupted.<br><br>
- <li>Filters not to download certain kind of files.<br><br>
- <li>You can get a site map before downloading.<br><br>
- <li>Getleft can follow links to external sites.<br><br>
- <li>Multilingual support, at present Getleft supports traditional Chinese, Dutch, English,
- Esperanto, German, French, Italian, Polish, Korean, Portuguese, Russian, Turkish and
- Spanish.<br><br>
- If you would like Getleft to support your own
- language, please check <a href=translate>this</a>.<br><br>
- <li>Some others not worth mentioning.<br><br>
-
- </ul>
-
- <h2>License</h2>
-
- <P>Getleft is licensed under the terms of the GPL version 2. This means you
- can do whatever you want with the program, except claim that you wrote it
- yourself and change the license.
-
- <P>It also means that Getleft comes with NO WARRANTY whatsoever, in fact, I
- would be surprised if it happened to work at all.
-
- <p>For the full details see <a href=GPL>the General Public License</a>.
-
- .topic GPL
- .title GNU General Public License
- <h3 align=center>GNU GENERAL PUBLIC LICENSE</h3>
- <h4 align=center>Version 2, June 1991</h4>
- <center><p><font size=-1>
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.<br>
- 675 Mass Ave, Cambridge, MA 02139, USA
- </font></p></center>
- <p>Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
- </p>
- <h4 align=center>Preamble</h4>
- <p>
- The licenses for most software are designed to take away your
- freedom to share and change it. By contrast, the GNU General Public
- License is intended to guarantee your freedom to share and change free
- software--to make sure the software is free for all its users. This
- General Public License applies to most of the Free Software
- Foundation's software and to any other program whose authors commit to
- using it. (Some other Free Software Foundation software is covered by
- the GNU Library General Public License instead.) You can apply it to
- your programs, too.
- </p><p>
- When we speak of free software, we are referring to freedom, not
- price. Our General Public Licenses are designed to make sure that you
- have the freedom to distribute copies of free software (and charge for
- this service if you wish), that you receive source code or can get it
- if you want it, that you can change the software or use pieces of it
- in new free programs; and that you know you can do these things.
- </p><p>
- To protect your rights, we need to make restrictions that forbid
- anyone to deny you these rights or to ask you to surrender the rights.
- These restrictions translate to certain responsibilities for you if you
- distribute copies of the software, or if you modify it.
- </p><p>
- For example, if you distribute copies of such a program, whether
- gratis or for a fee, you must give the recipients all the rights that
- you have. You must make sure that they, too, receive or can get the
- source code. And you must show them these terms so they know their
- rights.
- </p><p>
- We protect your rights with two steps: <$ head>(1)</$ head> copyright
- the software, and <$ head>(2)</$ head> offer you this license which gives
- you legal permission to copy, distribute and/or modify the software.
- </p><p>
- Also, for each author's protection and ours, we want to make certain
- that everyone understands that there is no warranty for this free
- software. If the software is modified by someone else and passed on, we
- want its recipients to know that what they have is not the original, so
- that any problems introduced by others will not reflect on the original
- authors' reputations.
- </p><p>
- Finally, any free program is threatened constantly by software
- patents. We wish to avoid the danger that redistributors of a free
- program will individually obtain patent licenses, in effect making the
- program proprietary. To prevent this, we have made it clear that any
- patent must be licensed for everyone's free use or not licensed at all.
- </p><p>
- The precise terms and conditions for copying, distribution and
- modification follow.
- </p>
- <h4 align=center>GNU GENERAL PUBLIC LICENSE<br>
- TERMS AND CONDITIONS FOR COPYING,
- DISTRIBUTION AND MODIFICATION</h4>
- <p>
- <$ head>0.</$ head> This License applies to any program or other work which contains
- a notice placed by the copyright holder saying it may be distributed
- under the terms of this General Public License. The "Program", below,
- refers to any such program or work, and a "work based on the Program"
- means either the Program or any derivative work under copyright law:
- that is to say, a work containing the Program or a portion of it,
- either verbatim or with modifications and/or translated into another
- language. (Hereinafter, translation is included without limitation in
- the term "modification".) Each licensee is addressed as "you".
- </p><p>
- Activities other than copying, distribution and modification are not
- covered by this License; they are outside its scope. The act of
- running the Program is not restricted, and the output from the Program
- is covered only if its contents constitute a work based on the
- Program (independent of having been made by running the Program).
- Whether that is true depends on what the Program does.
- </p><p>
- <a name=GNU_1><$ head>1.</$ head></a> You may copy and distribute verbatim copies of the Program's
- source code as you receive it, in any medium, provided that you
- conspicuously and appropriately publish on each copy an appropriate
- copyright notice and disclaimer of warranty; keep intact all the
- notices that refer to this License and to the absence of any warranty;
- and give any other recipients of the Program a copy of this License
- along with the Program.
- </p><p>
- You may charge a fee for the physical act of transferring a copy, and
- you may at your option offer warranty protection in exchange for a fee.
- </p><p>
- <a name=GNU_2><$ head>2.</$ head></a> You may modify your copy or copies of the Program or any portion
- of it, thus forming a work based on the Program, and copy and
- distribute such modifications or work under the terms of <a href=#GNU_1>Section 1</a>
- above, provided that you also meet all of these conditions:
- </p>
- <ul>
- <p>
- <$ head>a)</$ head> You must cause the modified files to carry prominent notices
- stating that you changed the files and the date of any change.
- </p><p>
- <$ head>b)</$ head> You must cause any work that you distribute or publish, that in
- whole or in part contains or is derived from the Program or any
- part thereof, to be licensed as a whole at no charge to all third
- parties under the terms of this License.
- </p><p>
- <$ head>c)</$ head> If the modified program normally reads commands interactively
- when run, you must cause it, when started running for such
- interactive use in the most ordinary way, to print or display an
- announcement including an appropriate copyright notice and a
- notice that there is no warranty (or else, saying that you provide
- a warranty) and that users may redistribute the program under
- these conditions, and telling the user how to view a copy of this
- License. (Exception: if the Program itself is interactive but
- does not normally print such an announcement, your work based on
- the Program is not required to print an announcement.)
- </p>
- </ul>
- <p>
- These requirements apply to the modified work as a whole. If
- identifiable sections of that work are not derived from the Program,
- and can be reasonably considered independent and separate works in
- themselves, then this License, and its terms, do not apply to those
- sections when you distribute them as separate works. But when you
- distribute the same sections as part of a whole which is a work based
- on the Program, the distribution of the whole must be on the terms of
- this License, whose permissions for other licensees extend to the
- entire whole, and thus to each and every part regardless of who wrote it.
- </p><p>
- Thus, it is not the intent of this section to claim rights or contest
- your rights to work written entirely by you; rather, the intent is to
- exercise the right to control the distribution of derivative or
- collective works based on the Program.
- </p><p>
- In addition, mere aggregation of another work not based on the Program
- with the Program (or with a work based on the Program) on a volume of
- a storage or distribution medium does not bring the other work under
- the scope of this License.
- </p><p>
- <$ head>3.</$ head> You may copy and distribute the Program (or a work based on it,
- under <a href=#GNU_2>Section 2</a>) in object code or executable form under the terms of
- <a href=#GNU_1>Sections 1</a> and <a href=#GNU_2>2</a> above provided that you also do one of the following:
- </p>
- <ul>
- <p>
- <$ head>a)</$ head> Accompany it with the complete corresponding machine-readable
- source code, which must be distributed under the terms of <a href=#GNU_1>Sections
- 1</a> and <a href=#GNU_2>2</a> above on a medium customarily used for software interchange; or,
- </p><p>
- <a name=GNU_3_b><$ head>b)</$ head></a> Accompany it with a written offer, valid for at least three
- years, to give any third party, for a charge no more than your
- cost of physically performing source distribution, a complete
- machine-readable copy of the corresponding source code, to be
- distributed under the terms of <a href=#GNU_1>Sections 1</a> and <a href=#GNU_2>2</a> above on a medium
- customarily used for software interchange; or,
- </p><p>
- <$ head>c)</$ head> Accompany it with the information you received as to the offer
- to distribute corresponding source code. (This alternative is
- allowed only for noncommercial distribution and only if you
- received the program in object code or executable form with such
- an offer, in accord with <a href=#GNU_3_b>Subsection b</a> above.)
- </p>
- </ul>
- <p>
- The source code for a work means the preferred form of the work for
- making modifications to it. For an executable work, complete source
- code means all the source code for all modules it contains, plus any
- associated interface definition files, plus the scripts used to
- control compilation and installation of the executable. However, as a
- special exception, the source code distributed need not include
- anything that is normally distributed (in either source or binary
- form) with the major components (compiler, kernel, and so on) of the
- operating system on which the executable runs, unless that component
- itself accompanies the executable.
- </p><p>
- If distribution of executable or object code is made by offering
- access to copy from a designated place, then offering equivalent
- access to copy the source code from the same place counts as
- distribution of the source code, even though third parties are not
- compelled to copy the source along with the object code.
- </p><p>
- <$ head>4.</$ head> You may not copy, modify, sublicense, or distribute the Program
- except as expressly provided under this License. Any attempt
- otherwise to copy, modify, sublicense or distribute the Program is
- void, and will automatically terminate your rights under this License.
- However, parties who have received copies, or rights, from you under
- this License will not have their licenses terminated so long as such
- parties remain in full compliance.
- </p><p>
- <$ head>5.</$ head> You are not required to accept this License, since you have not
- signed it. However, nothing else grants you permission to modify or
- distribute the Program or its derivative works. These actions are
- prohibited by law if you do not accept this License. Therefore, by
- modifying or distributing the Program (or any work based on the
- Program), you indicate your acceptance of this License to do so, and
- all its terms and conditions for copying, distributing or modifying
- the Program or works based on it.
- </p><p>
- <$ head>6.</$ head> Each time you redistribute the Program (or any work based on the
- Program), the recipient automatically receives a license from the
- original licensor to copy, distribute or modify the Program subject to
- these terms and conditions. You may not impose any further
- restrictions on the recipients' exercise of the rights granted herein.
- You are not responsible for enforcing compliance by third parties to
- this License.
- </p><p>
- <$ head>7.</$ head> If, as a consequence of a court judgment or allegation of patent
- infringement or for any other reason (not limited to patent issues),
- conditions are imposed on you (whether by court order, agreement or
- otherwise) that contradict the conditions of this License, they do not
- excuse you from the conditions of this License. If you cannot
- distribute so as to satisfy simultaneously your obligations under this
- License and any other pertinent obligations, then as a consequence you
- may not distribute the Program at all. For example, if a patent
- license would not permit royalty-free redistribution of the Program by
- all those who receive copies directly or indirectly through you, then
- the only way you could satisfy both it and this License would be to
- refrain entirely from distribution of the Program.
- </p><p>
- If any portion of this section is held invalid or unenforceable under
- any particular circumstance, the balance of the section is intended to
- apply and the section as a whole is intended to apply in other
- circumstances.
- </p><p>
- It is not the purpose of this section to induce you to infringe any
- patents or other property right claims or to contest validity of any
- such claims; this section has the sole purpose of protecting the
- integrity of the free software distribution system, which is
- implemented by public license practices. Many people have made
- generous contributions to the wide range of software distributed
- through that system in reliance on consistent application of that
- system; it is up to the author/donor to decide if he or she is willing
- to distribute software through any other system and a licensee cannot
- impose that choice.
- </p><p>
- This section is intended to make thoroughly clear what is believed to
- be a consequence of the rest of this License.
- </p><p>
- <$ head>8.</$ head> If the distribution and/or use of the Program is restricted in
- certain countries either by patents or by copyrighted interfaces, the
- original copyright holder who places the Program under this License
- may add an explicit geographical distribution limitation excluding
- those countries, so that distribution is permitted only in or among
- countries not thus excluded. In such case, this License incorporates
- the limitation as if written in the body of this License.
- </p><p>
- <$ head>9.</$ head> The Free Software Foundation may publish revised and/or new versions
- of the General Public License from time to time. Such new versions will
- be similar in spirit to the present version, but may differ in detail to
- address new problems or concerns.
- </p><p>
- Each version is given a distinguishing version number. If the Program
- specifies a version number of this License which applies to it and "any
- later version", you have the option of following the terms and conditions
- either of that version or of any later version published by the Free
- Software Foundation. If the Program does not specify a version number of
- this License, you may choose any version ever published by the Free Software
- Foundation.
- </p><p>
- <$ head>10.</$ head> If you wish to incorporate parts of the Program into other free
- programs whose distribution conditions are different, write to the author
- to ask for permission. For software which is copyrighted by the Free
- Software Foundation, write to the Free Software Foundation; we sometimes
- make exceptions for this. Our decision will be guided by the two goals
- of preserving the free status of all derivatives of our free software and
- of promoting the sharing and reuse of software generally.
- </p>
- <h4 align=center>NO WARRANTY</h4>
- <p>
- <$ head>11.</$ head> BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
- FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
- OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
- PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
- OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
- MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
- TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
- PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
- REPAIR OR CORRECTION.
- </p><p>
- <$ head>12.</$ head> IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
- WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
- REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
- INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
- OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
- TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
- YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
- PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
- POSSIBILITY OF SUCH DAMAGES.
- </p>
- <h4 align=center>END OF TERMS AND CONDITIONS</h4>
- </b>
- <h4 align=center>Appendix: How to Apply These Terms to Your New Programs</h4>
-
- <p>If you develop a new program, and you want it to be of the greatest
- possible use to the public, the best way to achieve this is to make it
- free software which everyone can redistribute and change under these terms.
-
- <p>To do so, attach the following notices to the program. It is safest
- to attach them to the start of each source file to most effectively
- convey the exclusion of warranty; and each file should have at least
- the "copyright" line and a pointer to where the full notice is found.
- <ul>
- <p> <one line to give the program's name and a brief idea of what it does.>
- <p> Copyright (C) 19yy <name of author>
-
- <p> This program is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation; either version 2 of the License, or
- (at your option) any later version.
-
- <p> This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- <p> You should have received a copy of the GNU General Public License
- along with this program; if not, write to the Free Software
- Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- </ul>
- <p>Also add information on how to contact you by electronic and paper mail.
-
- <p>If the program is interactive, make it output a short notice like this
- when it starts in an interactive mode:<br>
- <ul>
- Gnomovision version 69, Copyright (C) 19yy name of author<br>
- Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.<br>
- This is free software, and you are welcome to redistribute it<br>
- under certain conditions; type `show c' for details.<br>
- </ul>
- <p>The hypothetical commands `show w' and `show c' should show the appropriate
- parts of the General Public License. Of course, the commands you use may
- be called something other than `show w' and `show c'; they could even be
- mouse-clicks or menu items--whatever suits your program.
-
- <p>You should also get your employer (if you work as a programmer) or your
- school, if any, to sign a "copyright disclaimer" for the program, if
- necessary. Here is a sample; alter the names:
- <ul>
- <p>Yoyodyne, Inc., hereby disclaims all copyright interest in the program<br>
- `Gnomovision' (which makes passes at compilers) written by James Hacker.<br><br>
-
- <signature of Ty Coon>, 1 April 1989<br>
- Ty Coon, President of Vice<br>
- </ul>
- <p>This General Public License does not permit incorporating your program into
- proprietary programs. If your program is a subroutine library, you may
- consider it more useful to permit linking proprietary applications with the
- library. If this is what you want to do, use the GNU Library General
- Public License instead of this License.
-
-
-
- .topic translate
- .title Translating Getleft
- <p><img src=logo></p>
-
- <P>So, you want to translate Getleft to your favorite language? Let my
- first word to you be:
-
- <P><strong>THANKS!</strong>
-
- <P>or to put it in another way: Danke, merci, grace, obrigado, donkey shane,
- Mare-See, Key toss, M'goy, Graht-see-eh, Arigato, Spaciba, Gathee-oss,
- Tok,..., whatever suits you.
-
- <P>Translating the program is not hard, just boring, this is what you have
- to do:
-
- <P>Check that you have the latest version of Getleft, if you don't, the newest
- labels won't get translated, you can look it up
- <a href="tcl:Ayuda::InvokeBrowser http://personal1.iddeo.es/andresgarci/getleft/english/download.html">
- at my web page</a>.<br><br>
-
- <P>Check on of the 'menus' files in the archive, you can use whichever you want,
- but if you are reading this, the English one, menus.en, is probably your best choice.
-
- <P>Translate all entries, this is the boring part, and the reason I thank you
- so much.
-
- <P>The '&' symbols are used to indicated Getleft where to underscore the menu
- entries, please use them only in the menu section. For example, if you want
- the 'F' in the 'File' menu entry to be underscore, you have to write: '&File'.
-
- <P>Save this file with the name 'menus.xx', change the 'xx' to the two letter
- code that identifies your language, 'it' for Italian, 'de' for German,...
-
- <P>After doing this, check the 'supported' file and add an entry for your
- translation, for example, if you are doing a German translation add:
-
- <P>de Deutsch iso8859-1
-
- <P>The first column is the two letter code, the same you have just used to name
- the menus file.
-
- <P>The second is the name of the language.
-
- <P>The third is the encoding used for the fonts needed in that language. We are
- restricted to the encodings available in Tcl/Tk, to know which they are:<br><br>
-
- <b>
- wish<br>
- % encoding names<br>
- X11ControlChars ascii big5 cp1250 cp1251 cp1252 cp1253 cp1254 cp1255
- cp1256 cp1257 cp1258 cp437 cp737 cp775 cp850 cp852 cp855 cp857
- cp860 cp861 cp862 cp863 cp864 cp865 cp866 cp869 cp874 cp932 cp936
- cp949 cp950 dingbats euc-cn euc-jp euc-kr gb12345 gb1988 gb2312 identity
- iso2022 iso2022-jp iso2022-kr iso8859-1 iso8859-2 iso8859-3 iso8859-4
- iso8859-5 iso8859-6 iso8859-7 iso8859-8 iso8859-9 jis0201 jis0208 jis0212
- koi8-r ksc5601 macCentEuro macCroatian macCyrillic macDingbats macGreek
- macIceland macJapan macRoman macRomania macThai macTurkish macUkraine
- shiftjis symbol unicode utf-8<br><br>
- </b>
-
- <P>At least that's what I get with the version I have.
-
- <P>Now launch Getleft, and you should see the entry for your language in the 'Tools'
- menu.
-
- <P>Try it, check that the underscores are where they should, that the spelling is
- good,... and send both files to me. If possible compress the files before attaching
- them to mail, that way we won't lose any non-ascii characters.
-
- <P>I'll will include all translations with the next release and gobble all the
- merit (Isn't free software great?)
-
- <P>Okay, okay. Put your name and e-mail in the Copyright section of the file menus
- you have created, and I will put you in the History file and in the credits.
-
- .topic install
- .title Installing Getleft
- <p>
- <img src=logo></p>
-
-
- <h2>Requirements</h2>
-
- <p>Getleft works on Linux, I guess Unix variants will be fine, and Windows.<br>
-
- <p>Considering the Mac OS X is something like Unix and that there are Tcl/Tk and
- cURL versions for it, Getleft might work there, I don't have access to
- any Mac machines though, so I would be very grateful for any reports about it.
-
- <h2>Windows</h2>
-
- <p>Windows users have two options to install Getleft:
- <ul>
- <p><li>If you already have Tcl/Tk 8.1 or newer installed.
- <p><li>If you do not, and if you don't know, it means you don't.
- </ul>
- <p> In both cases, the procedure is similar, you
- <a href="tcl:Ayuda::InvokeBrowser http://personal1.iddeo.es/andresgarci/getleft/english/download.html">download</a>
- the appropiate <b>getleft-setup-v1.1.exe</b>, with or without Tcl/Tk,
- and double click on it to begin the install.
-
- <h3>Windows 95</h3>
-
- <p>Getleft doesn't work out of the box in Windows 95, you will need two
- things:
- <ul>
- <p><li><b>msvcrt.dll</b>: But if you have been using Win95 for some time
- you are likely to have it already.
-
- <p><li><b>Winsock version 2</b>: If Getleft tells you that the program cURL
- doesn't work, you need to download the winsock library, you can
- find it
- <a href="tcl:Ayuda::InvokeBrowser http://www.microsoft.com/windows95/downloads/contents/wuadmintools/s_wunetworkingtools/w95sockets2/default.asp">here</a>.
- </ul>
-
- <h2>Unix/Linux</h2>
-
- <h3>Tcl/Tk</h3>
-
- <P>Getleft is written in Tcl/Tk, an interpreted language created by
- <b>John Ousterhout</b>.
-
- <P>Getleft needs Tcl/Tk 8.1 or newer. It will, most definitely,
- not work with earlier versions.
-
- <P>In Linux you can get the version you have got by doing:<br>
-
- <pre>
- $ wish
- % puts $tcl_version
- </pre>
-
- <P>It may happen, specially if you are using Red Hat, that you don't have
- <b>wish</b>. You can know by doing:
-
- <pre>
- $ rpm -qa | grep tcl
- $ rpm -qa | grep tk
- </pre>
-
- <p>If one or both are missing you will have to install them, don't worry, they
- are in one of your distribution CDs.
-
- <P>If you need to download Tcl/Tk you can check at
- <a href="tcl:Ayuda::InvokeBrowser http://tcl.activestate.com">The Tcl developer Xchange</a>
-
- <h3>cURL</h3>
-
- <P>To do the actual downloading Getleft uses the program
- <a href="tcl:Ayuda::InvokeBrowser http://curl.haxx.se">cURL</a>
- by <a href="tcl:Ayuda::InvokeBrowser http://daniel.haxx.se">Daniel Stenberg</a>.
-
- <P>There are compiled versions of cURL for several operating
- systems, which you will be able to download at
- <a href="tcl:Ayuda::InvokeBrowser http://curl.haxx.se">cURL's site</a>
-
- <p>But usually, you won't need to download it, as it is included with
- most Linux distributions.
-
-
- <h3>Downloading Getleft</h3>
-
- <p>You can check which is the last version of the program at
- <a href="tcl:Ayuda::InvokeBrowser http://personal1.iddeo.es/andresgarci/getleft/english/download.html">Getleft's home page</a>
- .
-
- <P>In Linux you can choose the format of the package to download,
- there are 'rpm', 'deb' and 'tar.gz' packages available.
-
- <P>If you choose 'rpm' or 'deb' you are likely to know what to do with them.
-
- <p>For tarballs, you can install it in two ways:<br>
- <ul>
- <p><li>For you own exclusive use in you home directory.
-
- <p><li>System wide install for everyone to use.
- </ul>
-
- <p>In the first case, it is very simple, in fact if you
- have extracted the tarball in you home directory, you
- have already installed it.
-
- <p>In the second case, it is not much harder, you can use
- the 'install.tcl' script to do all the hard work for
- you. The usage of the script is:
-
- <p><b>./install.tcl</b>
-
- <p>In a graphical enviroment, a wizard will appear to help you
- with the install.
-
- <p>or in the console:
-
- <p><b>./install.tcl --prefix=/path ?--lang=LangCode? ?--proxy=proxyIP:proxyPort?</b>
-
- <p>Parameters:<br>
- <ul>
- <p><li>prefix: It can be either '/usr' or '/usr/local', if you
- think other paths should be available, please let me know.
-
- <p>This is the only required parameter.
-
- <p><li>lang: Code of the default language for Getleft, users will be
- able to overwrite it for their own use. It defaults to English.<br><br>
-
- <p><li>proxy: Default proxy to use.<br><br>
- </ul>
- <p>For example:
-
- <p><b>./install.tcl --prefix=/usr/local --lang=es --proxy=armando:80</b>
-
- <p>or
-
- <p><b>./install.tcl --prefix=/usr --proxy=192.168.0.1:80</b>
-
-
- <p>To run the program you will have to use a console and type
- either:
-
- <p><b>$ ./Getleft.tcl</b>
-
- <p>if you installed it in you home directory, or simply:
-
- <p><b>$ Getleft.tcl</b>
-
- <p>for a system wide install.
-
- <P>You can also set up your window manager so that you can click on an icon, in that case
- remember that the program to execute is
-
- <p><b>sh -f /path_to_getleft/Getleft.tcl</b>
-
- <p>I guess I should take care of doing that automagically, but I
- haven't yet.
-
-
-
- .topic toDo
- .title To Do
- <img src=logo></p>
- <P>Don't take this list too seriously, if you would like Getleft
- to do something not mentioned here, don't forget to let me know.
- <ul>
- <p><li>For 2.0<br><br>
- <ul>
- <p><li>Use Tcl's msgcat for translating.
-
- <p><li>Integrate TclCurl into Getleft.
-
- <p><li>Simultaneous downloads.
-
- <p><li>Use cURL's cookie support as soon as Linux distributors include version 7.9.1
-
- <p><li>Drag and drop support.
-
- <p><li>...
- </ul>
- </ul>
- <ul>
- <p><li>After 2.0
- <ul>
- <p><li>Maybe Java, Javascript,... support. I would need to get a clue about
- how to do it though.
- <p><li>Make Getleft work in the console, so you could do:<br><br>
- <b>$ Getleft -url http://www.somedomain.com -thumbs 0 -external 1</b><br><br>
- and have Getleft do it all for you without any questions.<br><br>
- I once got a request for this and I find it intriguing, is there any
- interest?
- </ul>
- </ul>
-
- .topic credits
- .title Credits
- <img src=logo></p>
-
- <P><h2>Author</h2>
-
- <P>Loath as I am to admit it, this is the brainchild of Andres Garcia,
- you can contact me:
-
- <P>By e-mail: fandom@retemail.es
-
- <P>or snail-mail
-
- <P><a href="tcl:Ayuda::InvokeBrowser http://personal1.iddeo.es/andresgarci/">AndrΘs Garcφa</a><br>
- Las Mestas 7, 3-3B<br>
- Gij≤n 33204<br>
- Asturias<br>
- Spain<br>
-
- <P>You may send all kinds of bug reports, Urls that don't work, patches, ...
-
- <h2>Contributors</h2>
- <ul>
-
- <li>I would like to mention <a href="tcl:Ayuda::InvokeBrowser http://www.beedub.com/">Brent Welch</a>, even
- though he probably has never heard of Getleft, his book "Practical Programming in Tcl
- and Tk" has help me a real lot, in fact some of his tricks can be found all around
- Getleft (the spaghetti code is all mine though).<br><br>
-
- <li><b>Jes·s</b>, another who is likely not to know what Getleft is, he passed
- me the combobox widget I use while we were at college, I think he had adapted it from
- somewhere else but I am not certain.<br><br>
-
- <li>The icons in the program have been taken from the
- <a href="tcl:Ayuda::InvokeBrowser http://www.kde-look.org/">KDE project</a><br><br>
-
- <li>Help balloons by <a href="tcl:Ayuda::InvokeBrowser http://droche.multimania.com">Daniel Roche</a> with
- some help by <a href="tcl:Ayuda::InvokeBrowser http://www.hwaci.com/drh/">Richard Hipp</a>
- and myself.<br><br>
-
- <li><b>Eliseo Vergara</b>: He passed me the 'SpinBox' widget a few years
- ago, again I don't know if he had done it all himself.<br><br>
-
- <li>The <a href="tcl:Ayuda::InvokeBrowser http://www.nemethi.de">multicolumn listbox</a> widget you can see in the main
- window of Getleft by <b>Csaba Nemethi</b>, who also took the time to review my
- code and suggested a couple of ways I could make a better use of it.<br><br>
-
- <li><a href="tcl:Ayuda::InvokeBrowser http://midc.miem.edu.ru/HelpSystem/index.php">Help system</a> by <b>Andrei A. Gratchev</b>.<br><br>
-
- <li>The configuration wizard that appears when you run Getleft for the
- first time was done using <a href="tcl:Ayuda::InvokeBrowser http://www.purl.org/net/oakley/tcl/tkwizard/index.html">'Tkwizard'</a>
- by <b>Brian Oakley</b>.<br><br>
-
- <li>The winkill extension used to cancel downloads in Windows systems is based on
- <a href="tcl:Ayuda::InvokeBrowser http://sourceforge.net/projects/tclx">TclX</a>
- code by <b>Karl Lehenbauer</b> and <b>Mark Diekhans</b>.<br><br>
-
- <li><a href="tcl:Ayuda::InvokeBrowser http://www.equi4.com/tclkit/">TclKit</a> used to create the Windows
- executables by <b>Jean-Claude Wippler</b>.<br><br>
-
- <li>The Windows setup programs are done using
- <a href="tcl:Ayuda::InvokeBrowser http://www.jrsoftware.org/isinfo.php">Inno Setup</a> by
- <b>Jordan Russell</b>.
- <p>The icon for the setup programs is there thanks to
- <a href="tcl:Ayuda::InvokeBrowser http://www.davidcornish.com>Inno Setup icon replacement</a>
- by <b>David Cornish</b>.<br><br>
-
- <li>The <a href="tcl:Ayuda::InvokeBrowser http://curl.haxx.se">cURL</a> program Getleft uses to do all the
- downloading by <a href="tcl:Ayuda::InvokeBrowser http://daniel.haxx.se">Daniel Stenberg</a>.
-
- </ul>
-
-
- <h2>Translators</h2>
- <ul>
- <li>Chinese (Traditional): <b>Tristesse</b><br><br>
- <li>Dutch: <b>Sander van Geloven</b><br><br>
- <li>Esperanto <b>Maarten van Gompel</b><br><br>
- <li>French: <b>Eric Seigne</b><br><br>
- <li>German: <b>H.J. Beckers</b><br><br>
- <li>Italian: <b>Mauro Spugla</b><br><br>
- <li>Korean: <b>Michael Kim</b><br><br>
- <li>Polish: <b>Ooshy</b> and <b>Marek Dankowski</b><br><br>
- <li>Portuguese: <b>Dennis Rosa</b><br><br>
- <li>Russian: <b>Vjacheslav Slobodjan</b><br><br>
- <li>Turkish: <b>Fisek Tⁿrkτe Grubu</b><br><br>
- </ul>
- <br>
-
- </td></tr></table>
-
- .topic register
- .title Register Getleft
- <img src=logo></p>
-
- <p><b>Q: Register Getleft, but I thought it was freeware?</b><br>
- A: Getleft is indeed free software, licensed under the
- <a href=GPL>General Public License</a>, which allows you to
- use, modify and copy the program in almost any way you want. But
- that doesn't mean I can't charge for it.
- <p>Anyway, I am only asking for a voluntary donation of 10$ (or euros),
- even if you don't do it you can still use the program, it is not crippled
- in any way.
-
- <p><b>Q: How can I register?</b><br>
- A: You can make the donation in three ways:
- <ul>
- <p><li>If you have a PayPal account, you can go to
- <a href="tcl:Ayuda::InvokeBrowser http://personal1.iddeo.es/andresgarci/getleft/english/download.html">the downloading page</a>,
- you will see a link to PayPal you can use to donate the money.
- <p><li>By credit card, please,
- <a href="tcl:Ayuda::InvokeBrowser https://orders.digitalcandle.com/order_php/order.php?productid=000907">click here</a>
- to start the process.
- <p><li>Sending the money by snail-mail, you can find my address
- in the <a href=credits>credits' page</a>
- </ul>
- <p><b>Q: What benefits do I get from registering?</b><br>
- A: None really, only the pleasant feeling of doing the right thing and
- ensuring that new versions of Getleft will keep coming your way.
-
- <p><b>Q: Why 10$?</b><br>
- A: It is a figure that I hope you will all be able to afford without
- a second thought.
-
- <p><b>Q: But, why should I send you any money if I am not getting anything
- extra from it?</b><br>
- A: Come on!, it is only 10$!, is it really worth arguing?
-
-
-
-
-
-
-
-